home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / gfx / misc / ShowComment.lha / ShowComment.doc < prev    next >
Text File  |  1996-09-01  |  8KB  |  190 lines
  1. ShowComment.rexx 1.03
  2. © 1995 Felix Coronado
  3. ------------------------
  4. ARexx program to display JPEG and GIF file comments
  5.  
  6.                          ------------------------
  7.  
  8.  Copyright and Distribution
  9.  ==========================
  10.  ShowComment.rexx is copyright 1995 by Felix Coronado.  All rights
  11.  reserved.
  12.  
  13.  
  14.  ShowComment.rexx is Freeware and it may be distributed only if:
  15.  
  16.  1. it is in its original unmodified form
  17.  2. it is accompanied by this documentation
  18.  3. nothing is charged for it, other than the cost of the media and nominal
  19.     duplication fees
  20.  
  21.  Any distribution of ShowComment.rexx that does not meet all of the above
  22.  requirements must have the prior written permission of the author (Felix C.
  23.  Coronado).
  24.  
  25.  Permission is granted to include ShowComment.rexx in Fred Fish's Amiga Disk
  26.  Library (including CD ROM versions of it) and the AmiNet CD ROMs.
  27.  
  28.                          ------------------------
  29.  
  30.  Disclaimer
  31.  ==========
  32.  This program (ShowComment.rexx) comes with no warranty, either expressed or
  33.  implied.  The author (Felix Coronado) is in no way responsible for any
  34.  damage, loss, or ill-effects directly or indirectly caused by the usage of
  35.  this program.
  36.  
  37.                          ------------------------
  38.  
  39.  What Does It Do?
  40.  ===============
  41.  ShowComment.rexx is an ARexx program that searches for and displays any text
  42.  comments contained in a JPEG or GIF file.
  43.  
  44.  NOTE: ShowComment.rexx will only search for comments in JFIF JPEG files, as
  45.  this is the only type of JPEG file that it was designed to recognize.  This
  46.  limitation is due to the fact that I have no information on the other
  47.  varieties (HSI JPEGs, TIFF JPEGs, PICT JPEGs, & others?) of JPEGs.  I don't
  48.  even know if they can contain comments.
  49.  
  50.                          ------------------------
  51.  
  52.  Requirements
  53.  ============
  54.  ARexx
  55.  
  56.                          ------------------------
  57.  
  58.  Installation
  59.  ============
  60.  Copy ShowComment.rexx to your S: directory or elsewhere.
  61.  
  62.                          ------------------------
  63.  
  64.  Using it
  65.  ========
  66.  ShowComment.rexx should be run from the Shell/CLI.  Its usage is as follows:
  67.  
  68.      RX ShowComment.rexx <filename>
  69.  
  70.  or if its "s" protection bit is set:
  71.  
  72.      ShowComment.rexx <filename>
  73.  
  74.  where <filename> is the complete path and filename of a JPEG or GIF file.
  75.  
  76.  Once it starts, ShowComment.rexx will display:
  77.  
  78.      ShowComment 1.03 - Copyright (c) 1995 by Felix Coronado
  79.  
  80.  If the file you pick is a JPEG or GIF file, ShowComment.rexx will then
  81.  display the following:
  82.  
  83.      Searching for comments in '<filename>'...
  84.      Ctrl-d to stop
  85.  
  86.  ShowComment.rexx is now searching the selected file for comments.  If you
  87.  press Ctrl-d (the "Ctrl" key and the "d" key at the same time) while "Ctrl-d
  88.  to stop" is displayed, ShowComment.rexx will stop searching for comments.
  89.  Pressing Ctrl-c while "Ctrl-d to stop" is displayed will abort the program.
  90.  
  91.  If you stop the search before any comments are found, or if no comments are
  92.  found, ShowComment.rexx will display the words "No Comment".
  93.  
  94.  If ShowComment.rexx is able to find comments, it will display the following:
  95.  
  96.      Comment <number>: <Comment>
  97.  
  98.                          ------------------------
  99.  
  100.  Contacting the Author
  101.  =====================
  102.  If you have any bug reports, questions, suggestions, comments, or gifts to
  103.  send me or if you would like information about the most recent versions of
  104.  my programs, I would be glad to hear from you.  I would particularly like to
  105.  hear from you if:
  106.  
  107.  1. You come across a JPEG or GIF file that you know contains comments but
  108.    ShowComment.rexx does not recognize it or does not display the comments.
  109.    If this occurs, I would appreciate it if you sent me a copy of the file so
  110.    that I could try to fix the problem.
  111.  
  112.  2. You have any information relating to:
  113.     a. JPEG and GIF file comments (programs that let you add/edit them, etc.)
  114.     b. the various JPEG file formats (the structure of JPEG files, what JPEG
  115.       file formats contain comments, etc.)
  116.  
  117.  I can be reached at:
  118.  
  119.  E-mail:
  120.         Internet: (if you don't get a reply from one address, try the other)
  121.                   felixthecat@geocities.com
  122.                   75460.722@compuserve.com
  123.  
  124.       CompuServe: 75460,722
  125.  
  126.  WWW: www.geocities.com/Paris/2866
  127.  
  128.                          ------------------------
  129.  
  130.  Version History
  131.  ===============
  132.  1.03 May 21, 1995 - Minor improvements
  133.  ---------------------------------------------------------------------------
  134.  1.02 April 5, 1995 - ShowComment.rexx can now detect GIF file comments
  135.                       shorter than 255 characters
  136.                     - ShowComment.rexx now displays only the actual comment
  137.                       text in GIF files
  138.                     - Multiple GIF file comments are now displayed separately
  139.                     - ShowComment.rexx no longer differentiates between JPEG
  140.                       "Creation info" comments and other JPEG file comments
  141.                     - Other minor improvements
  142.  ---------------------------------------------------------------------------
  143.  1.01 April 2, 1995 - Minor improvements
  144.  ---------------------------------------------------------------------------
  145.  1.00 March 26, 1995 - Changed name from ReadJPEG.rexx to ShowComment.rexx
  146.                      - Added support for GIF file comments
  147.                      - Files are now read in variable size blocks (default
  148.                        64K)
  149.                      - When using with JPEG files, ShowComment.rexx now
  150.                        searches the entire file for comments, instead of
  151.                        stopping at a certain point
  152.                      - Other minor improvements
  153.  ---------------------------------------------------------------------------
  154.  1.03 March 10, 1995 - ReadJPEG.rexx should now be able to recognize all
  155.                        JFIF JPEG files
  156.  ---------------------------------------------------------------------------
  157.  1.02 March 6, 1995 - ReadJPEG.rexx now detects multiple "Comment" comments
  158.                       if they are present and displays them as
  159.                       "Comment <number>"
  160.                     - Other minor improvements
  161.  ---------------------------------------------------------------------------
  162.  1.01 March 1, 1995 - Fixed a bug that could prevent ReadJPEG.rexx from
  163.                       detecting "Comment:" comments in certain rare cases
  164.  ---------------------------------------------------------------------------
  165.  1.0 February 23, 1995 - First public release
  166.  ---------------------------------------------------------------------------
  167.  
  168.                          ------------------------
  169.  
  170.  Other Stuff by Felix Coronado
  171.  =============================
  172.  Look for these other fine ARexx scripts/programs by Felix Coronado:
  173.  
  174.  Cataloger - ARexx script for The Art Department Professional v2.x or
  175.              MorphPlus.  Makes image catalogs containing thumbnails of
  176.              selected files.
  177.              Features include:
  178.              - Loads & saves most ADPro/MorphPlus file formats
  179.              - Many options, different combinations can be saved & loaded
  180.              - Files can be picked from requesters, FRED Sequence files, or
  181.                ASCII file lists
  182.  
  183.  GIF_+_Comment - ARexx script that acts as a pseudo-Loader for The Art
  184.                  Department Professional v2.5.  Loads a GIF file while
  185.                  displaying any text comments contained in the file.
  186.  
  187.  JPEG_+_Comment - ARexx script that acts as a pseudo-Loader for The Art
  188.                   Department Professional v2.5.  Loads a JPEG file while
  189.                   displaying any text comments contained in the file.
  190.